<html>
<head>
<title>PDS -- Planetary Data System</title>
</head>

<body bgcolor="#ffffff">

<h1>PDS -- Planetary Data System</h1>

PDS is a format used primarily by NASA to store and distribute
solar, lunar and planetary imagery data.  GDAL provides read-only
access to PDS formatted imagery data.<p>

PDS files often have the extension .img, sometimes with an associated
.lbl (label) file.  When a .lbl file exists it should be used as
the dataset name rather than the .img file.<p>

In addition to support for most PDS imagery configurations, this
driver also reads georeferencing and coordinate system information
as well as selected other header metadata.<p>

Implementation of this driver was supported by the United States
Geological Survey.<p>

<hr>

Due to ambiguities in the PDS specification, the georeferencing of
some products is subtly or grossly incorrect.  There are configuration
variables which may be set for these products to correct the interpretation
of the georeferencing.  Some details are available in
<a href="http://trac.osgeo.org/gdal/ticket/3940">ticket #3940</a>.<p>

For example, the MOLA labels currently contain a one pixel offset. Once
<a href="http://trac.osgeo.org/gdal/ticket/5941">ticket #5941</a> is applied (should be available post 1.11.3),
which corrects the PDS offset defaults, here is how you can correctly read in
a MOLA label using the --config options in the PDS reader.
<p>
$ gdalinfo  --config PDS_SampleProjOffset_Shift -0.5 --config PDS_LineProjOffset_Shift -0.5  mola.lbl
<p>
For LOLA global PDS files the center should be perfectly 0.0, 0.0 meters in Cartesian space.

example conversion:<p>
$ gdal_translate --config PDS_SampleProjOffset_Shift -0.5 --config PDS_LineProjOffset_Shift -0.5  mola.lbl out.tif
<p>
example conversion and applying offset and multiplier values as defined in some PDS labels:<p>
$ gdal_translate -ot Float32 -unscale  --config PDS_SampleProjOffset_Shift -0.5 --config PDS_LineProjOffset_Shift -0.5  mola.lbl out_32bit.tif
<p>
As a test, this lunar
<a href="http://pds-geosciences.wustl.edu/lro/lro-l-lola-3-rdr-v1/lrolol_1xxx/data/lola_gdr/cylindrical/img/ldem_4.lbl">LOLA PDS label</a>
should be perfectly centered at 0.0, 0.0 meters in Cartesian space without any configuration options. Remember you will need a GDAL version post 1.11.3.<p>
$ gdalinfo  ldem_4.lbl
<p>
To test the --config keyword above, this Mars <a href="http://pds-geosciences.wustl.edu/mgs/mgs-m-mola-5-megdr-l3-v1/mgsl_300x/meg004/megt90n000cb.lbl">MOLA PDS label</a>
should be perfectly centered at 0.0, 0.0 meters in Cartesian space with the following configuration options. Remember you will need a GDAL version post 1.11.3.<p>
$ gdalinfo  --config PDS_SampleProjOffset_Shift -0.5 --config PDS_LineProjOffset_Shift -0.5  megt90n000cb.lbl
<p>

<p>
<hr>

PDS is part of a family of related formats including ISIS2 and ISIS3.<p>

<h2>See Also:</h2>

<ul>
<li> Implemented as <tt>gdal/frmts/pds/pdsdataset.cpp</tt>.
<li> <a href="http://pds.nasa.gov/">NASA Planetary Data System</a>
<li> <a href="frmt_isis2.html">GDAL ISIS2 Driver</a>
<li> <a href="frmt_isis3.html">GDAL ISIS3 Driver</a>
</ul>

</body>
</html>
